home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Diamond Collection
/
The Diamond Collection (Software Vault)(Digital Impact).ISO
/
cdr38
/
kspslp12.zip
/
KSP-SLIP.DOC
< prev
next >
Wrap
Text File
|
1995-03-05
|
47KB
|
1,503 lines
KSP SLIP (tm)
A SLIP Door for Bulletin Board Systems
Version 1.2
Copyright (C) 1995
All Rights Reserved
by
KEY SOFTWARE PRODUCTS
440 Ninth Avenue
Menlo Park, California 94025-1802
BBS/FAX: 415-364-9847
KSP SLIP is a trademark of Key Software Products.
PCL4C is a trademark of MarshallSoft Computing.
WATTCP is a trademark of Erick Engelke.
Power C is a trademark of Mix Software.
Lantastic is a trademark of Artisoft, Inc.
Novell is a trademark of Novell Corp.
Banyan Vines is a trademark of Banyan Inc.
TABLE OF CONTENTS
CHAPTER 1 - INTRODUCTION ........................... 1
1.1 Compatibility with BBS Software ............... 2
1.2 Hardware Requirements ....................... 2
1.3 Software Requirements ....................... 2
1.4 Other KSP Software ........................... 3
1.4.1 KSP Telnet ............................. 3
1.4.2 KSP FTP ................................ 3
1.4.3 So Many CD's ............................ 3
CHAPTER 2 - INSTALLATION ........................... 4
2.1 Packet Driver Shims for Novell ................. 4
2.2 Packet Driver Shims for Lantastic .............. 5
2.2.1 Changes to CONFIG.SYS ................... 5
2.2.2 Changes to PROTOCOL.INI ................. 5
2.3 Packet Driver Shims for Banyan Vines ............ 6
2.4 Other Things to Configure ..................... 6
CHAPTER 3 - THE WATTCP CONFIGRATION FILE .............. 8
3.1 Using a BOOTP Server .......................... 8
3.2 Manual Configuration ........................ 9
3.2.1 The PC's Host Name ....................... 9
3.2.2 The PC's Domain Name ..................... 9
3.2.3 The PC's IP Address ...................... 10
3.2.4 The Name Server's IP Address .............. 10
3.2.5 The Router's IP Address .................. 10
3.2.6 The PC's Network Mask .................... 10
3.3 TCP/IP Parameters (optional) ................. 11
3.3.1 Timeouts .............................. 11
3.3.2 Maximum Segment Size (MSS) ............... 11
3.4 KSP SLIP Parameters .......................... 11
3.4.1 Session Time Limit ...................... 11
3.4.2 Inactivity Limit ....................... 12
3.4.3 Minimum Baud Rate ....................... 12
3.4.4 Operating Hours ........................ 12
3.4.5 Startup Message ........................ 12
3.4.6 Minimum Baud Rate Message ................ 13
3.4.7 Operating Hours Message ................. 13
3.4.8 User Session Logging .................... 13
3.4.9 SLIP Packet Monitor ..................... 13
3.4.10 Non-Standard Serial Port ............... 14
CHAPTER 4 - INSTALLING THE SLIP DOOR COMMAND ........... 15
CHAPTER 5 - INSTALLING YOUR ACCESS KEY ................ 16
CHAPTER 6 - CUSTOMIZING THE DISPLAY FILES ............. 17
6.1 PCBoard Display Macros ....................... 17
6.2 Macros Unique to KSP SLIP ...................... 17
6.3 Justification and Spacing .................... 17
6.3.1 No Justification ....................... 18
TABLE OF CONTENTS
6.3.2 Left Justification ..................... 18
6.3.3 Center Justification ................... 18
6.3.4 Right Justification .................... 18
6.4 The DISPLAY Program .......................... 18
APPENDIX 1 - HOW TO REACH US .......................... 20
APPENDIX 2 - GETTING UPDATES VIA THE INTERNET .......... 21
APPENDIX 3 - LEGAL STUFF ............................ 22
Mar 05, 1995 KSP SLIP (tm) v1.2 1
CHAPTER 1 - INTRODUCTION
Many BBS's now offer E-Mail access to the Internet. But few if
any offer a real TCP/IP connection. As compared to mere E-Mail
access, providing a TCP/IP connection opens up a large number of
new possibilities to callers, such as the ability to remote
login to Internet hosts in foreign countries using Telnet, or to
access files on those hosts using FTP, or to search for
information using Gopher, Archie, and the new multimedia
hypertext browser, Mosaic.
KSP SLIP establishes a logical two-way connection between the
user's serial line and the Internet:
+----------+ |
User's | | | Local Area Network
Modem <----->| KSP SLIP |<----+ connected to the
| | | Internet
+----------+ |
BBS Machine
As indicated, the physical connection between the BBS machine
and the Internet is usually by means of an Ethernet card
attached to a local area network that is attached to the
Internet. However, this connection could instead be simply a
separate modem connection to a commercial Internet access
provider, such as NETCOM.
TCP/IP encapsulates data in packets and transfers those packets
according to a specific communication protocol. Data on the
serial line between the BBS and the caller must obey this
protocol; KSP SLIP does this using a popular protocol called
SLIP (Serial Link Internet Protocol). Of course the caller must
also be using software at his end that also supports SLIP; there
are several shareware products for this purpose, available from
the Key Software Products BBS.
KSP SLIP meets the following BBS-specific needs:
1. Terminates the BBS session when user's time limit
expires.
2. Terminates the BBS session when user hangs up.
3. Terminates when there's no activity for a
sysop-specified period of time.
4. Records the SLIP session in a log file.
5. Provide colorized or parameterized messages to
user.
6. Restrict users by baud rate.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 2
7. Restrict hours of operation.
KSP SLIP is shareware. The unlicensed version is fully
functional except that it imposes a maximum of five minutes per
SLIP session. Once licensed, the user is limited only by the
amount of time remaining in his BBS session.
KSP SLIP was implemented using Erick Engelke's Waterloo TCP
library, MarshallSoft Computing's PCL4C Personal Communications
library, and Mix Software's Power C compiler.
1.1 Compatibility with BBS Software
KSP SLIP is compatible with any BBS software that can generate a
DOOR.SYS file. It works with a BBS configured to use the
standard COM1 through COM4 ports, or will automatically detect
and use a Fossil driver.
1.2 Hardware Requirements
KSP SLIP inherently requires that the PC running your BBS
software have a physical connection to a TCP/IP network -
normally the Internet. Ideally, this connection is by means of
an adapter card connected to an Ethernet at your company or
school (and then through a "gateway" to the Internet).
It is also possible to connect to the Internet through a
commercial Internet Access Provier via a dial-up SLIP (Serial
Line Internet Protocol) connection. This approach requires a
second serial port, modem, and telephone line dedicated to this
purpose. Information on finding such a provider is available on
the KSP BBS.
1.3 Software Requirements
KSP SLIP runs on top of another piece of software called a
"packet driver". The packet driver presents a standard software
interface to KSP SLIP, regardless of the type of hardware
interface that connects the PC to the network. Public domain
packet drivers exist for SLIP links and most Ethernet cards.
If your BBS uses a multi-tasking operating system to run
multiple nodes on a single PC, then you will need a "packet
multiplexer". If your PC is connected to a non-TCP/IP
proprietary network (such as Novell or Lantastic), you will
probably need a packet driver "shim".
An assortment of public domain packet drivers, multiplexers, and
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 3
shims are available on the KSP BBS.
1.4 Other KSP Software
Key Software Products offers a number of other products for
BBS's:
1.4.1 KSP Telnet
A door program that allows callers to connect to remote
computers anywhere on the Internet via your BBS. Available now
on our BBS.
1.4.2 KSP FTP
A door program that allows callers to transfer files to/from
remote computers anywhere on the Internet via your BBS. (This
product is currently under development; expected release is
summer of 1995.)
1.4.3 So Many CD's
A PCBoard PPE to handle off-line CD-Roms. Seamlessly integrated
into PCBoard. Users post requests for off-line files and have
then returned as attachments to messages. Configurable message
pack-out dates automatically keep your hard disk from getting
cluttered. Available now on our BBS.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 4
CHAPTER 2 - INSTALLATION
Before installing KSP SLIP as a BBS door, you must first
install:
1. The network interface hardware.
2. A corresponding packet driver.
3. A packet driver shim (if needed).
4. A packet multiplexer (if needed).
Detailed directions for these preliminary steps are available in
separate documentation that comes with the corresponding
hardware or software.
It's most common that multi-node BBS's are interconnected with
Ethernet and either Lantastic or Novell. Unfortunately, these
two network operating systems were designed using their own
proprietary protocols rather than the TCP/IP protocol and their
own proprietary software rather than packet drivers to talk to
their Ethernet interface cards. However, a piece of software
called a packet driver "shim" can be used to let both TCP/IP and
their proprietary protocol coexist.
2.1 Packet Driver Shims for Novell
Novell's network software is installed in layers as TSRs in the
order shown below. These commands are usually found either in
the AUTOEXEC.BAT file or in another batch file in a directory
typically called C:\NWCLIENT.
LSL
NE2000 <-- specific to your interface card
IPXODI
VLM
The packet driver shim (ODIPKT) logically sits on top of IPXODI,
providing a packet driver interface for software such as KSP
SLIP:
LSL
NE2000
IPXODI
ODIPKT 2 0x61 <--- The packet driver shim
VLM
The ODIPKT command line parameters may vary according to which
version of the software you have and how your hardware is
configured. The necessary packet driver shim can be downloaded
from the Key Software Products BBS as file ODI-SHIM.ZIP.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 5
2.2 Packet Driver Shims for Lantastic
Using a packet driver shim with Lantastic requires that
Lantastic be installed using NDIS (Network Driver Interface
Specification) Support. The necessary packet driver shim can be
downloaded from the Key Software Products BBS as file
DIS-SHIM.ZIP.
NDIS allows you to stack multiple protocols on a single
adapter. This lets you use multiple protocol drivers (such as
LANtastic and TCP/IP) on the same adapter. You can also use
NDIS to include third-party adapters that have NDIS drivers in
your LANtastic network. Supported adapter types include
Ethernet, Token-Ring and ARCNET (R) adapters. The software and
documentation necessary to add NDIS support to an existing
Lantastic network is available free of charge from Artisoft.
Once you have NDIS installed and working with Lantastic, adding
the shim is a simple matter of editing PROTOCOL.INI (part of the
NDIS support) and CONFIG.SYS.
2.2.1 Changes to CONFIG.SYS
With NDIS installed, there will be two device driver lines in
your CONFIG.SYS file that look something like the following:
DEVICE=C:\LANTASTI\PROTMAN.DOS /I:C:\LANTASTI
DEVICE=C:\LANTASTI\AEXNDIS.DOS
The file listed in the second line may differ if you are not
using Artisoft's interface card; in that case, this file would
typically be replaced by a NDIS driver supplied by the card
manufacturer.
The packet driver shim itself is installed as a third device
driver after the first two, as in:
DEVICE=C:\LANTASTI\PROTMAN.DOS /I:C:\LANTASTI
DEVICE=C:\LANTASTI\AEXNDIS.DOS
DEVICE=C:\DRIVERS\DIS_PKT.DOS
2.2.2 Changes to PROTOCOL.INI
The PROTOCOL.INI file is a text file created (usually in the
C:\LANTASTI directory) as part of the NDIS installation. Before
adding the packet driver shim, it typically looks like the
following, but with the "iobase" and "interrupt" parameters
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 6
changed according to your hardware, or with the entire
"[AEXNDIS_NIF]" section replaced if you are not using an
Artisoft interface card.
[PROTMAN]
DRIVERNAME = PROTMAN
DYNAMIC = YES
[AEXNDIS_NIF]
DRIVERNAME = AEXNDS
IOBASE = 0x300
INTERRUPT = 15
Adding the packet driver shim requires adding another section to
the PROTOCOL.INI file:
[PROTMAN]
DRIVERNAME = PROTMAN
DYNAMIC = YES
[AEXNDIS_NIF]
DRIVERNAME = AEXNDS
IOBASE = 0x300
INTERRUPT = 15
[PKTDRV]
DRIVERNAME = PKTDRV
BINDINGS = AEXNDIS_NIF
INTVEC = 0x61
CHAINVEC = 0x66
NOVELL = Y
Note that the name "AEXNDIS_NIF" must exactly match the spelling
used as the title of the previous section, "[AEXNDIS_NIF]"; if
you are not using Artisoft interface cards, then both occurences
will use some other identifier. The "INTVEC" parameter may be
anything from 0x60 to 0x80; you may have to experiment to find
an unused interrupt number.
2.3 Packet Driver Shims for Banyan Vines
Although Key Software Products has never used it, and thus
cannot offer help on its installation, a packet driver shim does
exist for Banyan Vines and can be downloaded from the Key
Software Products BBS as file BAN-SHIM.ZIP.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 7
2.4 Other Things to Configure
Once your network is up and running with a packet driver or a
packet driver shim, there are basically two additional steps:
1. Create a WATTCP.CFG configuration file.
2. Configure KSP SLIP as a BBS door.
As discussed in the next chapter, you may not need a WATTCP.CFG
configuration file if you have a BOOTP server.
There is a useful program called TCPINFO available on the KSP
BBS. If you have no WATTCP.CFG file, it will tell you (after a
maximum of 30 seconds) if it was able to automatically configure
itself via a BOOTP server. If you have a WATTCP.CFG file, it
will determine whether or not you have configured that file
properly.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 8
CHAPTER 3 - THE WATTCP CONFIGRATION FILE
In order to run, KSP SLIP needs to know some information about
your network. It tries to find this in a configuration file
called WATTCP.CFG in the current directory. If not found, it
then looks for an environment variable called "WATTCP.CFG" that
specifies the directory where the WATTCP.CFG file might be
found. For example, if you place WATTCP.CFG in your PCB
directory, then your AUTOEXEC.BAT file should contain the
following command:
set WATTCP.CFG=C:\PCB
Note that there is no trailing "\" after the directory name!
If KSP SLIP still can't find the configuration file, it will
attempt to automatically configure itself by looking for a
"BOOTP" server on your network. (BOOTP is a standard protocol
that obtains your "IP address" and other information about your
PC from a BOOTP server.) If there is no BOOTP server, or if
your PC is not registered in its database, then you must create
a configuration file.
The configuration file contains one entry per line. A sample
configuration file is included in this distribution, but the
values MUST be modified to suit your particular environment or
else KSP SLIP will not work!
The syntax of every entry follows the following format:
[ directive = [ "data" | data] ] [ # comment | ; comment ]
I.e., if a directive is not followed by data, the directive is
ignored. Similary, lines without directives are ignored. The
directive is NOT case sensitive; the data IS case sensitive.
e.g., netmask=255.255.252.0
domainslist=ksp.com ; Our domain
Whitespace is normally removed from data; data containing blanks
must be surrounded by quotes. An unquoted '#' or ';' marks the
beginning of a comment.
3.1 Using a BOOTP Server
It's always a good idea to have a configuration file whether or
not you use a BOOTP server. If you choose to use a
configuration file and want to tell it to use the BOOTP server,
this option allows you to specify your the IP address of your
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 9
BOOTP server.
Example: bootp=129.255.0.128
You should specify the domain name manually as described in the
next section since the BOOTP protocol doesn't provide that
information.
Example: domainslist=ksp.com
NOTE: An "IP address" is a logical addressing scheme used on
TCP/IP networks such as the Internet. Each computer connected
to the Internet is assigned a unique IP address. Your local
network "guru" or access provider should be able to provide you
with those IP addresses you need.
IMPORTANT: The IP addresses given in this document are only
examples. Do NOT attempt to use them - they will NOT work and
your network administrator will probably get VERY upset!
3.2 Manual Configuration
If you don't have a BOOTP server, or if your PC is not
registered with a BOOTP server, then you must use the following
directives to configure KSP SLIP. The values of these
parameters are important, and KSP SLIP will NOT function
properly without the proper values. If you are not familiar
with the terminology, or if you are unsure of the proper values,
please consult with your network access provider.
3.2.1 The PC's Host Name
This is the network name of the PC that runs your BBS (and thus
KSP SLIP). If your BBS is implemented by a network of PC's,
then each PC should have its own unique host name.
Example: hostname=bbs
Note that the host name does not include the domain name
suffix. For example, the hostname of machine '"bbs.ksp.com" is
simply "bbs".
3.2.2 The PC's Domain Name
This is the network name of the subnet to which your PC (and
possibly others) are connected.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 10
Example: domainslist=ksp.com
Note that the domain name does not include the host name
prefix. For example, the domain name of machine '"bbs.ksp.com"
is "ksp.com".
3.2.3 The PC's IP Address
This is the unique IP address assigned to your PC.
Example: my_ip=100.2.37.4
Your local network "guru" or access provider should be able to
provide you with the proper IP address of your PC. Note that
you should have a different IP address for each node in your
BBS.
3.2.4 The Name Server's IP Address
This is the unique IP address assigned to a network name
nerver. You may specify more than on nameserver by using more
than one "nameserver" line.
Example: nameserver=111.21.108.110
Your local network "guru" or access provider should be able to
provide you with the proper IP addresses of appropriate network
name servers.
3.2.5 The Router's IP Address
This is the unique IP address assigned to the network router.
Syntax: gateway = ipaddr [ , subnet [ , subnet_mask ] ]
Examples: gateway=129.97.176.1
gateway=129.97.176.2, 129.97.0.0
gateway=129.97.176.2, 129.97.0.0, 255.255.0.0
Usually the (destination) subnet and subnet mask need not be
specified, and is used to create a "default". The other forms
are used to specify one or more other gatewaya for particular
subnets.
Your local network "guru" or access provider should be able to
provide you with the proper IP address of the network router.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 11
3.2.6 The PC's Network Mask
Network masks are used to distinguish destination IP addresses
that are on the local subnet from those that are not. This
option may not be required, depending on your network topology.
Example: netmask=255.255.254.0
Your local network "guru" or access provider should be able to
provide you with the proper netmask if needed.
3.3 TCP/IP Parameters (optional)
KSP SLIP will work without using the following parameters, but
they are provided if you wish to change them.
3.3.1 Timeouts
Most network operations (such as establishing a connection to a
remote host) have a maximum time before a timeout error occurs.
The default value is 30 seconds; a smaller value is unwise, but
larger values may be necessary for particularly bad
connections.
Example: sockdelay=40
3.3.2 Maximum Segment Size (MSS)
The default value of MSS is 1400. If you know what maximum
segment size means and know what size you want, you can change
it:
Example: mss=512
3.4 KSP SLIP Parameters
Some of the parameters in WATTCP.CFG are specific to KSP SLIP.
These options specify operating limits and display files needed
while KSP SLIP is running:
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 12
3.4.1 Session Time Limit
Syntax: ksp-slip.max_mins=<number>
Example: ksp-slip.max_mins=30
Purpose: Overrides the time remaining as specified in DOOR.SYS
if lower. If omitted, time remaining is that specified
by DOOR.SYS.
3.4.2 Inactivity Limit
Syntax: ksp-slip.idle_mins=<minutes>
Example: ksp-slip.idle_mins=10
Purpose: Establishes an upper limit on how long the session can
remain inactive before it is terminated. If omitted,
no inactivity limit is imposed.
3.4.3 Minimum Baud Rate
Syntax: ksp-slip.minbaud=<baudrate>[,<security>]
Example: ksp-slip.minbaud=9600
Example: ksp-slip.minbaud=9600,100
Purpose: Specifies a minimum baud rate required to use the
gateway, and an optional security level required to
override the minimum baud rate. If omitted, no minimum
baud rate will be required.
3.4.4 Operating Hours
Syntax: ksp-slip.ophours=<hh:mm-hh:mm>
Example: ksp-slip.ophours=21:00-23:00
Purpose: To establish the hours of operation for the gateway;
attempts to use the gateway at other times will be
disallowed. Times must be specified in 24 hour
format. If omitted, the gateway may be used at any
time.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 13
3.4.5 Startup Message
Syntax: ksp-slip.startup_msg=<filespec>
Example: ksp-slip.startup_msg=c:\ksp-slip\startup.msg
Purpose: Specifies the location of a display file sent to the
user when the gateway is initialized. If omitted, no
display file is sent.
3.4.6 Minimum Baud Rate Message
Syntax: ksp-slip.minbaud_msg=<filespec>
Example: ksp-slip.minbaud_msg=c:\ksp-slip\minbaud.msg
Purpose: Specifies the location of a display file sent to the
user if the his baud rate is less than that required by
the "ksp-slip.minbaud" option (described earlier). If
omitted, no display file is sent.
3.4.7 Operating Hours Message
Syntax: ksp-slip.ophours_msg=<filespec>
Example: ksp-slip.ophours_msg=c:\ksp-slip\ophours.msg
Purpose: Specifies the location of a display file sent to the
user if the he attempts to use the gateway at other
than the hours specified by the "ksp-slip.ophours"
option (described earlier). If omitted, no display
file is sent.
3.4.8 User Session Logging
Syntax: ksp-slip.log_dir=<pathspec>
Example: ksp-slip.log_dir=c:\ksp-slip
Purpose: Specifies the name of a directory where a log of user
sessions will be kept. The log files are named
KSP-SLIP.???, where "???" is the BBS node number.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 14
3.4.9 SLIP Packet Monitor
Syntax: ksp-slip.status=<method>
Example: ksp-slip.status=direct
Purpose: Enables local console display of SLIP packet counts and
selects output method. Options are "direct" (fastest),
"bios", and "ansi" (slowest). If running under a
multi-tasker, you may need to specify "ansi" or "bios";
otherwise use "direct".
3.4.10 Non-Standard Serial Port
Syntax: ksp-slip.serial_port=<adr>,<irq>
Example: ksp-slip.serial_port=3F8,5
Purpose: Used to override serial port and IRQ values implied by
"COMx" in DOOR.SYS to support non-standard
configurations that are not using a fossil driver. The
port address <adr> must be specified in hex, and the
interrupt request line number <irq> must be specified
in decimal. Has no effect when using a fossil driver.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 15
CHAPTER 4 - INSTALLING THE SLIP DOOR COMMAND
Install KSP SLIP as you would any other door program on your
BBS. Be sure you setup the BBS to create a DOOR.SYS file for
KSP SLIP when it runs. (KSP SLIP does not need a USER.SYS
file.) If you are running multiple BBS nodes accessing a single
copy of the file KSP-SLIP.EXE, then don't forget to make that
file read-only using the DOS ATTRIB command in order to avoid
sharing conflicts.
Most BBS's use a batch file to run a door. For example, on
PCBoard systems you might create a door batch file called "SLIP"
containing simply:
C:\KSP-SLIP\KSP-SLIP
BOARD
Of course, you must also configure your BBS so it knows where to
find this batch file (SLIP).
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 16
CHAPTER 5 - INSTALLING YOUR ACCESS KEY
The unlicensed version of KSP SLIP limits each user to a maximum
of five minutes per session. To remove this limit, you must
purchase an access key and install it as described below; once
installed, users will be limited only by their time remaining on
the BBS.
There are three parameters that must be specified in two
environment variables called "KSP-ID" and "KSP-SLIP" in order to
install your access key; the access key will not be validated if
any parameter is missing.
The environment variable "KSP-ID" is used to specify your BBS
name, as in:
set ksp-id=Key Software Products BBS
The environment variable "KSP-SLIP" is used to specify the
number of BBS nodes and your access key separated by a semicolon
as in:
set ksp-slip=2;12345678
The access key is derived from the name of your BBS and the
number of BBS nodes. The specified key must match the
combination of BBS name and nodes. If not, or if you invoke KSP
SLIP on a node whose node number is greater than indicated, then
the caller will be limited to five minutes per session.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 17
CHAPTER 6 - CUSTOMIZING THE DISPLAY FILES
The distribution package includes three sample display files:
OPHOURS.MSG Displayed during off hours
STARTUP.MSG Displayed on start of gateway session
LOSPEED.MSG Displayed if baud rate is too low
These files have been customized by the use of certain
predefined "macros". Some of these macros are a subset of those
supported by PCBoard, while others are unique to KSP SLIP.
6.1 PCBoard Display Macros
The following PCBoard display macros, plus all of PCBoard's
"@X##" color control macros, may be used within KSP SLIP display
files. For a description of what they represent, refer to the
PCBoard documentation.
@BEEP@ @CLREOL@ @CLS@
@FIRST@ @MINLEFT@ @SECURITY@
@SYSDATE@ @SYSTIME@ @USER@
@POS:#@
6.2 Macros Unique to KSP SLIP
The following additional display file macros are also supported
by KSP SLIP.
@SLIPIP@ The IP address of the BBS node
@SLIPNAME@ The SLIP node's network name
@DCESPEED@ Current DCE (carrier) speed
@DTESPEED@ Current DTE (PC-Modem) speed
@EXPIRETIME@ Expire time in HH:MM format
@IDLEMINS@ Maximum inactivity time
@MINDCESPEED@ Minimum DCE (carrier) speed
@OPHOURS@ Hours of operation
@OVERRIDE@ Override security for mindcespeed
6.3 Justification and Spacing
Any of the text insertion macros used in KSP SLIP display files
can appear in one of four forms as discussed in the following
paragraphs. These options allow you to precisely control
spacing, and allow you to draw a box around a message - even
when replacement text within a line has a varying length.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 18
6.3.1 No Justification
Syntax: @<keyword>@
Example: @USER@
Purpose: Inserts the replacment text, using as many columns as
are necessary.
6.3.2 Left Justification
Syntax: @<keyword>:<number>@
or: @<keyword>:<number>L@
Example: @USER:15@
or: @USER:15L@
Purpose: Insert the replacement text, left justifying it within
a field whose width is specified by the number
following the colon. If more columns are required than
provided in the field width, the field is expanded.
macro.
6.3.3 Center Justification
Syntax: @<keyword>:<number>C@
Example: @USER:15C@
Purpose: Insert the replacement text, centering it within a
field whose width is specified by the number following
the colon. If more columns are required than provided
in the field width, the field is expanded.
6.3.4 Right Justification
Syntax: @<keyword>:<number>R@
Example: @USER:15R@
Purpose: Insert the replacement text, right justifying it within
a field whose width is specified by the number
following the colon. If more columns are required than
provided in the field width, the field is expanded.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 19
6.4 The DISPLAY Program
Included among the distribution files is DISPLAY.EXE, a program
that helps design a display file by allowing it to be viewed
offline. The command line syntax is:
DISPLAY [-g] [-7] <filespec>
Where: <filespec> Is the name of the display file.
The filename extension defaults
to ".MSG" if omitted.
[] Denotes an optional argument.
-g Disables (color) graphics and
ANSI control sequences.
Default is enabled and requires
ANSI.SYS to be installed.
-7 Replaces 8-bit graphics characters
with suitable 7-bit alternatives.
If a KSP SLIP configuration file with the name KSP-SLIP.CFG is
in the current directory, DISPLAY will use values specified by
that file for its various text insertion macros such as @USER@.
Otherwise, DISPLAY will use a predefined set of replacement
strings.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 20
APPENDIX 1 - HOW TO REACH US
The Key Software Products BBS/FAX number (415-364-9847) operates
24 hours a day, 7 days a week. Software at our end
automatically determines whether an incoming call is data or FAX
and will operate accordingly.
If you have access to electronic mail, you can send us a message
via any of the following:
On COMPUSERVE, send mail to:
>Internet:tech.support@ksp.com
On PRODIGY, send mail to: VGDC59A
On Internet, UUCP, or Bitnet, send mail to:
tech.support@ksp.com
On Fidonet, address mail to "UUCP" at nearest fidonet site which
provides a gateway to Internet, such as 1:105/42.
1st line of message: To: tech.support@ksp.com
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 21
APPENDIX 2 - GETTING UPDATES VIA THE INTERNET
The main distribution file is KSPSLP??.ZIP, where "??" is the
version number.
This file is available from the KSP BBS, either by calling in
and downloading, or via e-mail using the "LISTSERV" capabilities
of the BBS; we do NOT have "real" FTP capability in case you
were wondering.
To use LISTSERV, you must send a message addressed to the
Internet address listserv@ksp.com. The message must contain an
LISTSERV command entered as a single line of text, and it must
be the first line in the message. The LISTSERV commands that are
supported include:
Command: HELP tlbmm-l
Purpose: Returns an text file with help information about LISTSERV.
Command: DIR tlbmm-l
Purpose: Returns an e-mail message listing all of the file
directories on the BBS by number and description.
Command: LIST tlbmm-l 1
Purpose: Returns an e-mail message listing all of the files in
directory #1 of the BBS.
Command: GET tlbmm-l KSPSLP12.ZIP
Purpose: Returns an e-mail message containing a uuencoded version of
the file KSPSLP12.ZIP. To extract the file, you must save
the message as a file on your system, edit out the e-mail
header at the beginning of the file, and then use a program
called UUDECODE (commonly available on Unix) to convert the
uuencoded version back to the original ZIP format, and then
(finally) use PKUNZIP to extract the contents of the file.
Copyright (C) 1995, Key Software Products. All Rights Reserved
Mar 05, 1995 KSP SLIP (tm) v1.2 22
APPENDIX 3 - LEGAL STUFF
LIMITED WARRANTY
This software is provided 'as is' without warranty of any kind,
either expressed or implied, including, but not limited to the
implied warranties of merchantability and fitness for a
particular purpose. The entire risk as to the quality and
performance of the program is with you.
Some states do not allow the exclusion of implied warranties, so
the above exclusions may not apply to you. This warranty gives
you specific legal rights and you may also have other rights
which vary from state to state.
Key Software Products has taken due care in preparing the
documentation and software included in to ascertain their
correctness and effectiveness. However, Key Software Products
does not warrant that operation of this software will be
uninterrupted or error free. In no event shall Key Software
Products be liable for incidental or consequential damages in
connection with or arising out of the furnishing, performance,
or use of this software.
LICENSE
You MAY use this software on any computer or computers in your
possession. The licensed version is registered for use on up to
a fixed number of BBS nodes running on multiple machines and/or
multiple multi-tasking processes.
You MAY copy this software into any machine readable or printed
form for backup or modification purposes in support of your use
of the software.
You MAY distribute the original unmodified, unlicensed version
of this software, but you may not charge a fee exceeding $5.00
to cover the cost of duplicating, shipping, and handling. You
may NOT distribute a licensed version of this software.
You may NOT use, copy, modify, sublicense, assign or transfer
this software and its license, or any copy or modification, in
whole or in part, except as expressly provided for in this
license.
Copyright (C) 1995, Key Software Products. All Rights Reserved